EBSILON®Professional Online Dokumentation
EbsScript dient in erster Linie zur automatisierten Verarbeitung der in EBSILON hinterlegten Daten. Eine Änderung der Topologie der Schaltung ist mit EbsScript nicht möglich. Dies muss mit dem grafischen Editor gemacht werden.
In vielen Fällen ist es jedoch hilfreich, aus EbsScript heraus auf Topologiefunktionen zugreifen zu können. Um z.B. von einer Komponente aus auf die Werte der angeschlossenen Leitungen zurückgreifen zu können, muss man wissen, welche Leitung wo angeschlossen ist. Dies wird durch spezielle Topologie-Funktionen (in diesem Fall getPipeAtLink) ermöglicht, die im Kapitel Vorgabewertfunktionen beschrieben sind.
Es gibt jedoch eine vereinfachte Syntax, mit der man auf Anschlüsse zurückgreifen kann. Hierbei sind auch Verschachtelungen möglich.
|
Syntax |
Beschreibung |
Beispiel |
|
compname._i |
Leitung an Pin i |
Generator._2.Q Elektrische Generatorleistung |
|
compname.__i |
Komponente am anderen Ende der Leitung an Pin i |
Dampferzeuger.__2.ETAI Wirkungsgrad |
|
pipename._in |
Komponente am Eingang der Leitung |
Elektro._in.ETAG Generatorwirkungsgrad |
|
pipename._out |
Komponente am Ausgang der Leitung |
L_Frischdampf._out.ETAI Wirkungsgrad HD-Turbine |
| comp.__[Anschlussnummer] | Zugriff auf nächstes Bauteil (KEINE Leitung, welches über eine Leitung an Anschluss „Anschlussnummer" verbunden ist. | turbine.__6 gibt das mit dem Wellenausgang der Turbine verbundene Bauteil zurück |
| comp.__[Anschlussnummer]d | Zugriff auf nächstes Bauteil oder Leitung, welches über eine Leitung an Anschluss „Anschlussnummer" verbunden ist. | transmitter.__1d gibt das mit dem Eingang des Signalübertragers verbundene Objekt zurück |
| comp.__[Anschlussnummer]p | Zugriff auf nächste Leitung (KEIN Bauteil), welches über eine Leitung an Anschluss „Anschlussnummer" verbunden ist. | regler.__3p gibt die mit dem Stellgrößenausgang des Reglers verbundene Leitung zurück |
| pipe._in und ._out | Zugriff auf nächstes Bauteil (KEINE Leitung), welches mit dem Ein- bzw. Austritt der Leitung verbunden ist. | water._in gibt das mit dem Eintritt der Wasserleitung verbundene Bauteil zurück |
| pipe._ind und ._outd | Zugriff auf nächstes Bauteil oder Leitung, welches mit dem Ein- bzw. Austritt der Leitung verbunden ist. | logic._ind gibt das mit dem Eintritt der Logikleitung verbundene Objekt zurück |
| pipe._inp und ._outp | Zugriff auf nächste Leitung (KEIN Bauteil), welches mit dem Ein- bzw. Austritt der Leitung verbunden ist. | scheduled._inp gibt die Leitung zurück, auf die die Sollwertleitung zeigt |
Die EbsScript-Funktion getLogicObj() kann benutzt werden, um auf an einer Leitung andockende Wertekreuze, Bauteile wie 45, 46 etc. und andere Logikleitungen zugreifen zu können.
Der Wert von "Kurzbezeichnung" eines Anschlusses eines Makros kann als Alias für den Leitungszugriff verwendet werden. Um verwendbar zu sein, muss der Wert der Kurzbezeichnung den Anforderungen für einen EbsScript-Variablennamen entsprechen.
|
Syntax |
Beschreibung |
zurückgegebener Datentyp |
Beispiel |
|
ebsmacrobase._x[Alias]: |
Gibt die Leitung zurück, die mitdem durch den Alias angegebenen Anschluss verbunden ist. |
ebspipe |
::NAMEOFMACRO._xPORT_E (Alias:PORT_E) |
|
ebsmacrobase .__x[Alias] |
Gibt die Komponente zurück, die mit der anderen Seite der Leitung verbunden ist und mit dem durch den Alias angegebenen Anschluss verbunden ist |
ebscomp |
::NAMEOFMACRO.__xPORT_E (Alias:PORT_E) |
|
ebsmacrobase .__px[Alias]: |
Gibt die Leitung zurück, die mit der anderen Seite der Leitung verbunden ist und mit dem durch den Alias angegebenen Anschluss verbunden ist |
ebspipe |
::NAMEOFMACRO.__pxPORT_E (Alias:PORT_E) |
|
ebsmacrobase .__dx[Alias]: |
Gibt das Datenobjekt (Komponente oder Leitung) zurück, das mit der anderen Seite der Leitung verbunden ist und mit dem durch den Alias angegebenen Anschluss verbunden ist. |
ebsdata |
::NAMEOFMACRO.__dxPORT_E (Alias:PORT_E) |
[Alias] ist durch den angegebenen Kurzbezeichner zu ersetzen.